home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / disk / xdu21dvx.zip / XDU.TXT < prev    next >
Text File  |  1993-07-28  |  7KB  |  196 lines
  1.  
  2.  
  3. XDU(1)                     Unix Programmer's Manual                     XDU(1)
  4.  
  5.  
  6. NAME
  7.      xdu - display the output of "du" in an X window
  8.  
  9. SYNOPSIS
  10.      du | xdu [options]
  11.  
  12. DESCRIPTION
  13.      Xdu  is  a  program  for  displaying  a  graphical  tree  of  disk  space
  14.      utilization  as reported by the UNIX utility "du".  The user can navigate
  15.      through the  tree  structure  and  change  the  order  of  the  displayed
  16.      information.   The  window  is  divided  up into several columns, each of
  17.      which is one level deeper  in  the  directory  hierarchy  (from  left  to
  18.      right).   Boxes  are  drawn  for  each directory.  The amount of vertical
  19.      space occupied by each box is directly proportional to the amount of disk
  20.      space consumed by it and all of its children.  The name of each directory
  21.      and the amount of data are displayed provided that there is enough  space
  22.      within  its  box.   Any space at the "bottom" of a box not covered by its
  23.      children to the right represents the space  consumed  by  files  in  that
  24.      directory (as opposed to space from its children).
  25.  
  26.      There are several command line options available.   Equivalent  resources
  27.      (if any) are shown with each option.
  28.  
  29.      +s   (.showsize: true) display sizes (the default).
  30.  
  31.      -s   (.showsize: false) don't display sizes.
  32.  
  33.      -c num
  34.           display num columns.
  35.  
  36.      -a   (.order: alpha) sorts display alphabetically.
  37.  
  38.      -ra  (.order: ralpha) sorts display reverse alphabetically.
  39.  
  40.      -n   (.order: size) sorts display numerically (largest first).
  41.  
  42.      -rn  (.order: rsize) sorts display reverse numerically (smallest first).
  43.  
  44.      -fg color
  45.           (.foregound) determines the color of the text and lines.
  46.  
  47.      -bg color
  48.           (.background) determines the color of the background.
  49.  
  50.      -rv  reverse video (for monochrome displays)
  51.  
  52.      In addition to these the  usual  toolkit  options  such  as  -rv,  -font,
  53.      -display, -geometry, are supported.
  54.  
  55. MOUSE ACTIONS
  56.      The user can move up or down the tree by clicking the  left  mouse  on  a
  57.      directory  box.   If the left most box is selected, the display will move
  58.      up one level (assuming you are not already at the root).   If  any  other
  59.      box  is  selected,  it will be placed against the left edge of the window
  60.      and the display will be rescaled appropriately.  At any time  the  middle
  61.      mouse  will  bring  you  back to the root.  Clicking the right mouse will
  62.  
  63.  
  64.                                      X11                                     1
  65.  
  66.  
  67.  
  68. XDU(1)                     Unix Programmer's Manual                     XDU(1)
  69.  
  70.  
  71.      exit the program.
  72.  
  73. KEYSTROKES
  74.      Several keystroke commands are supported.  Note that all sorting  happens
  75.      from  the  current  root node down, so it is possible to sort one subtree
  76.      differently than another by clicking into it, doing  a  sort,  and  going
  77.      back up to the parent.
  78.  
  79.      1-9,0
  80.           sets the number of columns in the display (0 = 10).
  81.  
  82.      a    alphabetical sort.
  83.  
  84.      n    numerical sort (largest first).
  85.  
  86.      f    first-in-first-out sort (this is the order the data  was  read  into
  87.           the program).
  88.  
  89.      l    last-in-first-out sort.
  90.  
  91.      r    reverse sense of sort.
  92.  
  93.      h    display a keyboard help message to standard out.
  94.  
  95.      i    display information about the current root  node  to  standard  out.
  96.           The  first  line shows the path within the tree, the total size from
  97.           this node on down, and the precentage that total represents  of  all
  98.           of  the  data given to xdu.  Subsequent lines show the size and name
  99.           information for all children of this node  in  the  order  they  are
  100.           currently  sorted  in.  This allows tiny directories to be seen that
  101.           otherwise could not be labled on the display, and  also  allows  for
  102.           cutting and pasting of the information.
  103.  
  104.      /    goto the root.
  105.  
  106.      q    (or Escape) exit the program.
  107.  
  108. ACTIONS
  109.      All mouse and keyboard events trigger actions so they can all be  rebound
  110.      by translations to suit the individual.  The action functions are:
  111.  
  112.      reset()
  113.           goes to the root node.
  114.  
  115.      goto()
  116.           moves down into the directory currently under the mouse (and is thus
  117.           probably only useful bound to a mouse button).
  118.  
  119.      quit()
  120.           exits the program.
  121.  
  122.      reorder(type)
  123.           sorts the display from the current root node down according  to  one
  124.           of:   alpha,   ralpha   (reverse  alphabetical),  size  (largest  to
  125.           smallest), rsize (smallest to largest), first  (as  originally  read
  126.           in),  last  (opposite  of  original data), reverse (reverse whatever
  127.  
  128.  
  129.                                      X11                                     2
  130.  
  131.  
  132.  
  133. XDU(1)                     Unix Programmer's Manual                     XDU(1)
  134.  
  135.  
  136.           sort mode is currently selected).
  137.  
  138.      size()
  139.           toggles size display on/off
  140.  
  141.      ncol(num)
  142.           sets the number of columns to num.
  143.  
  144.      info()
  145.           displays directory information as described in the KEYBOARD section.
  146.  
  147.      help()
  148.           displays a keystroke help message to standard out.
  149.  
  150.      As an example of rebinding these, you could put  the  following  in  your
  151.      resources file:
  152.  
  153.      XDu*translations: #override\n\
  154.                <Key>X: reorder(reverse)\n\
  155.            <Btn3Down>: info()
  156.  
  157.      to make the 'x' key reverse the current sort order and  the  right  mouse
  158.      button print the directory information message.
  159.  
  160. RESOURCES
  161.      The following resources are supported with some sample values.
  162.  
  163.      XDu.foreground: yellow
  164.      XDu.background: blue4
  165.      XDu*window.width: 600
  166.      XDu*window.height: 480
  167.      XDu.ncol: 5
  168.      XDu.font: -*-helvetica-bold-r-normal--14-*
  169.      XDu.showsize: False
  170.      XDu.order: size
  171.  
  172. EXAMPLE
  173.      cd /usr/src
  174.      du > /tmp/du.out
  175.      xdu -n /tmp/du.out
  176.  
  177. BUGS
  178.      On some machines keyboard input may not be  accepted  by  xdu  until  the
  179.      mouse  is  moved  out of and back into the window.  I have been told that
  180.      putting the following in your resources file may fix this.
  181.  
  182.      <window manager name>.FocusLenience: True
  183.  
  184. SEE ALSO
  185.      du(1)
  186.  
  187. AUTHOR
  188.      Phillip C. Dykstra
  189.      <phil@arl.army.mil>
  190.  
  191.  
  192.  
  193.  
  194.                                      X11                                     3
  195.  
  196.